PATH  Mac OS X Server Documentation > Mac OS X Server Release Notes

[Back]

Mac OS X Server Release Notes Copyright ©1998 by Apple Computer, Inc. All Rights Reserved.

Mac OS X Server Developer Release Notes:
Java AWT

This file contains release notes for the Mac OS X Server and Yellow Box for Windows release of the Java Abstract Window Toolkit (AWT). The AWT provides platform-independent graphical user interface services for applications written in Java. This release of the AWT is based on the JDK version 1.1.6 from Sun Microsystems.

Notes Specific to Customer Release 1

Features

The Java AWT for Mac OS X Server is fully compliant with the AWT API specification from Sun. In order to access the AWT Java classes, the following class archive file must be in your CLASSPATH environment variable:

/System/Library/Frameworks/JavaVM.framework/Classes/awt.jar

This file is already part of the default CLASSPATH, so there is no need to add it unless you are explicitly setting up your own CLASSPATH. For more information on the CLASSPATH, see the Java VM release notes (/System/Documentation/Developer/YellowBox/ReleaseNotes/JavaVM.html)

All AWT peer classes are implemented as subclasses Yellow Box views (NSView class). This allows the components to function with the exact platform appearance. In addition, this allows AWT-based Java beans to be embedded in Yellow Box applications through the use of Interface Builder. See the Java Beans Palette release notes for more information (/System/Documentation/Developer/YellowBox/ReleaseNotes/JavaBeansPalette.html).

Known Problems

• When a Java Bean component based on Swing (JFC) is embedded in a Yellow Box application, the Swing classes (swingall.jar) must appear in the Java class path after the AWT classes (awt.jar). The default class path uses the correct ordering, so this is only an issue if your application is constructing its own class path when starting the Java VM. The class path order is not an issue at all if the application is 100% pure Java. A bug in Swing release 1.0.2 (which persists in 1.0.3) requires a patch to the SwingUtilities class. Because the patched class is in awt.jar, awt.jar must appear before swingall.jar in order for the VM to find and load the patched class.
  
• If you are using a version of Swing other than 1.0.2, you need to set up the class path so that your Swing classes are before the system's default Swing classes.
  
• Saving, restarting and cloning applets is unreliable. The appletviewer tool is based on the sun.applet.AppletViewer class, which supports saving, restarting and cloning applets via the Applet menu. Few applets support these features correctly, however, so it is common for exceptions to be raised when attempting one of these operations. The Reload command is reliable.
  
• Audio quality is poor at times. When playing sounds, you may notice some clicking and popping.

These bugs are known to exist in Customer Release 1 of the AWT:

Reference	2005449
Problem	Scroll bars do not scale width.
Description	The AWT allows scroll bars of varying width (for vertical scrollers) or height (for horizontal scrollers), but the native Yellow Box does not yet support this capability. Scroll bars wider than 16 pixels still appear 16 pixels wide, while scroll bars narrower than 16 pixels are clipped to the correct width without scaling the appearance. In either case, the scroll bars are fully functional.
Workaround	Use scroll bars with the default width.